home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1996 #6 / Amiga Plus CD - 1996 - No. 06.iso / pd / tools / coloursetter / cs.docs < prev    next >
Text File  |  1996-08-09  |  16KB  |  301 lines
  1.  
  2.                      The Documents for Coloursetter
  3.  
  4.  
  5.  
  6.  
  7.                      *** About This Program ***
  8.  
  9. ColourSetter is a handy little program which is intended to compliment 
  10. the Workbench palette requester program, which while it is good, even 
  11. in the multicolour setting it can only set the first eight colours of the 
  12. palette. I often found that the  colours above this limit clashed with each 
  13. other, and the only way that I could fix it was to select one of the preset
  14. colour selections,  which is hardly user friendly to the user who wishes to
  15. have a totally customised workbench! So I wrote this little program.
  16. ColourSetter is intended to compliment the Workbench palette requester, not
  17. necessarily to replace it, so please do not delete your workbench palette 
  18. requester. 
  19.  
  20.  
  21.  
  22.  
  23.                          *** Installation ***
  24.  
  25. If you are running the demo version of ColourSetter then no installation is
  26. necessary as the program will quite happily run from the disk it came on. If
  27. you got this program from the Internet, or a BBS then after de-archiving it
  28. to your selected drawer, the program will run quite happily `as is'. 
  29.  
  30. If you are using the full version then an installation script is provided and
  31. everything is placed in it's correct place automatically.
  32. The installation script for the full version will automatically add a command
  33. to you user-startup script telling Workbench to check for your colour
  34. preferences and if they exist to alter the colours to your preferences.
  35. Ifyou lose your colours at any point (for instance if another program has 
  36. been run which altered the workbench colours, then provided the file entitled
  37. CRd (or CRd-AGA) is present in your Prefs drawer (it will be if you have 
  38. saved from ColourSetter at least once) then just press the right Amiga and E 
  39. keys together to bring up the command window, then type in the command `CR'
  40. (or `CR_AGA' for AGA users) and press Return. Your colour prefernces will 
  41. appear as if by magic! 
  42.  
  43.  
  44.  
  45.                       *** How The Program Works ***
  46.  
  47. When Coloursetter loads the program superimposes itself over the Workbench 
  48. screen, so that you can see whats going on with the Workbench while you are
  49. setting your colours. No exiting the program to see if it works, and then
  50. having to reload when you find it doesn't! 
  51. The main window looks rather like DPaint's palette requester (this is a 
  52. colour changing program after all!) with gadgets showing every colour 
  53. that your workbench is set up for, as well as three sliding gadgets  which 
  54. let you set each colour. All you simply need to do is select the colour you 
  55. wish to edit by clicking on it once with the left mouse button and then 
  56. select the `RGB'  (RedGreenBlue) value you desire.  For instance to 
  57. alter the amount of red in your chosen colour just position the mouse 
  58. pointer over the indicator on the `R' sliding gadget, press and hold the 
  59. left mouse button, move the mouse left or right as desired, and release 
  60. the mousebutton. You will see the value to the left of the slider change to
  61. its new value and everything on the screen in that colour change to the new
  62. colour. Try this with the screen colour (the first one) for the most dramatic
  63. effects!
  64. Once you have set your personal colours, you can select an option from the 
  65. gadgets under the main window or the menu (both of which have identical 
  66. functions). 
  67.  
  68.  
  69.  
  70.  
  71.                      *** The Menu and Gadgets ***
  72.  
  73. The gadgets under the main window contian the same commands as the menu, so 
  74. the following explanations apply to both the gadgets and the menu. 
  75.  
  76. Save:     This option is disabled on the demo version, so if you are 
  77.           using this version, you will need to buy the full version in  
  78.           order to use this option. Please see the section entitled   
  79.           `How to Buy the Full Version' further on in this document       
  80.           for more info on this.
  81.  
  82.           The save option allows you to save the colours that you         
  83.           have set up. When this is selected a file in the prefs drawer  
  84.           of  your workbench entitled CRd (or CRd_AGA for AGA users) is 
  85.           altered (or created if it doesn't already exist). This file tells
  86.           your workbench what your colour preferences are and sets them 
  87.           accordingly.
  88.  
  89.           After saving the Coloursetter program will exit.
  90.  
  91. Use:      This option sets your workbench to the colours that you          
  92.           have chosen, but does not save them, meaning that when      
  93.           you reset your computer your colour selections will be lost,    
  94.           and your workbench will be set to the colours you last             
  95.           saved, or if you didn't save any at all, then your Workbench 
  96.           will be set to its default colours. 
  97.                
  98.           On selecting this option the ColourSetter program will exit.
  99.  
  100. Cancel:   This option will reset the workbench colours to those when  
  101.           ColourSetter was first loaded and then exit the program.            
  102.           In other words, the program will have had no effect on                
  103.           your workbench palette.
  104.  
  105. Reset:    This option will reset your workbench palette to the way it 
  106.           was when ColourSetter was loaded (or the way it was when you last
  107.           saved.  All your editing to date will be lost, and you will need 
  108.           to start again from scratch.         
  109.  
  110. About:    This option will bring up a third window which will display the 
  111.           Programs name, version and author. When you have finished reading
  112.           this information, just push the left mouse button to exit this 
  113.           window. The mouse pointer doesn't necessarily need to be in the 
  114.           About window to exit, but be aware that if the mouse pointer is
  115.           positioned over a gadget then that gadget will be activated. For
  116.           instance: if you only intend to come out of the `About' window but
  117.           the mousepointer is positioned over the `Cancel' gadget then the
  118.           program will exit. 
  119.  
  120. Owner:    This option is intended as a copyright protection. When you 
  121.           select this option a window appears showing who the rightful      
  122.           owner of the particular copy being used is. The name and address 
  123.           which appears here cannot be altered by the user. It is set by
  124.           Samsof before sending the program to the person who ordered it. 
  125.           Except for demo versions, each copy of this program is sold on 
  126.           condition that it is used only by the purchaser, who is given 
  127.           permission to make one back-up copy for his / her own use. If you
  128.           are offered a copy of this program which does not have your name
  129.           and address in the Owner window, then please let me know as this is
  130.           PIRACY and THEFT and is HIGHLY ILLEGAL.
  131.  
  132.           If you are using a demo version of this program then the above  
  133.           will not be applicable as the demo version is freely available to 
  134.           all. So, provided that it is not altered in any way and these 
  135.           documents are not removed or altered, you may spread the demo 
  136.           version around as much as you like. In fact please do!
  137.  
  138.  
  139.  
  140.                      *** Using the Demo Version ***
  141.  
  142. If you are using the demo version then you may have noticed a little 
  143. limitation as to what you can do. With the demo version you can only edit the 
  144. first eight colours of your workbench palette and you can't save your editing 
  145. for future use. In order to overcome both these limitations you will need to
  146. buy the full version. For details of how to do this see the next section.
  147.  
  148.  
  149.  
  150.  
  151.                         
  152.                    *** How To Buy the Full Version ***
  153.  
  154. Just having the demo version could get a little frustrating after a while 
  155. because you cannot save your preferences or edit the full palette. However 
  156. there is a solution to this. In exchange for £7.50 you can get a copy of the 
  157. full version with nothing disabled. Just send a cheque or postal order to me 
  158. at the address below. I do not recommend sending cash through the post, 
  159. because if it should get lost I cannot be held responsible. Don't forget to 
  160. tell me your full name and address, and please do remember that The full 
  161. version does require a hard drive in order to function properly.  
  162. The price of £7.50 includes £1.50 postage, packing and the price of a disk, 
  163. so if you send me a blank DoubleSidedDoubleDensity Diskette along with a 
  164. stamped addressed envelope (preferably a Jiffy bag in order to protect the 
  165. disk) then you need only pay £5.00 for the program.
  166. Unfortunately, due to the nature of computer software, once your 
  167. program has been dispatched I will be unable to give you a refund 
  168. should you change your mind later and decide you want to return the 
  169. program. If on receiving your disk you find it is faulty then you should 
  170. return the faulty disk to me and I will replace it with a good one, but I 
  171. cannot give a refund.
  172.  
  173.  
  174.  
  175.                          *** Known Bugs ***
  176.  
  177. I am not aware of any bugs in this program, however if you should find 
  178. one, then please do let me know.
  179.  
  180.  
  181.  
  182.  
  183.                        **** Copyright Notice ****
  184.  
  185. This program, along with all the others that I have written, and will 
  186. write in the future are copyrighted to Samsof, which is my trade name. This 
  187. copyright includes all ideas, graphics, layout, music, source code and the 
  188. programs themselves. All versions of programs which are released as `freely
  189. distributable' may be copied and distributed freely, providing that they have
  190. not been altered in any way, and that all programs, files and documentation
  191. that came with them remains with them, and is not altered in any way. The 
  192. copyright for all freely distributable software still remains with Samsof, 
  193. therefore such software may not be used for any comercial purpose whatsoever, 
  194. without written permission of Samsof. 
  195. Should a magazine publisher decide to include a Samsof program on a coverdisk
  196. then the program MUST have been released as freely distributable and no part
  197. of the program or its related files may be altered or removed. I also ask all
  198. magazine publishers to let me know before putting any Samsof program on a
  199. coverdisk.
  200.  
  201. PD suppliers should not charge any more than a VERY SMALL fee for PD released 
  202. software. This fee should be for postage, packing and diskettes only, and 
  203. should not include hefty profits for PD libraries. If you can only get PD 
  204. software for what seems like an exhorbatant price, then remember that Samsof
  205. PD only charges 75p per disk. Just about any PD released software can be
  206. obtained, so just let me know what you want! 
  207.  
  208. If you are using a full version of one of my programs, then please 
  209. remember that the program was supplied to you on condition that you 
  210. do not make copies of it (apart from a single back-up copy for your own 
  211. use only, which I recommend you do), and that you certainly don't 
  212. spread the program around. 
  213. I have included a routine in every program which lets me know who I 
  214. originaly sold a particular copy to (this may not always be seen by the 
  215. user, but believe me it's there), so if you spread the program around, 
  216. everyone  will know who did it, and believe me,  software pirates are 
  217. NOT WELCOMED by the honest Amiga community, not to mention 
  218. what I will think of you. If it comes to my attention that someone has 
  219. been spreading  illegal copies of any of my programs, I will not supply 
  220. any further programs to that individual, and if I consider the situation 
  221. warrants it, I may well take further action. 
  222.                                               YOU HAVE BEEN WARNED.  
  223.  
  224.  
  225.                           *** Disclaimer ***
  226.  
  227. Although I do my utmost best to ensure that programs written by me 
  228. work properly and will not cause any damage to your files or equipment, 
  229. all software is supplied at the users own risk. I cannot be held 
  230. responsible for any damage resulting from the use or misuse of my 
  231. programs. All disks are checked for viruses before being sent out, but I 
  232. cannot be held responsible should a computer virus enter your system, 
  233. which was not detected by my virus checkers. I do my utmost to ensure 
  234. no viruses enter my computer, because believe me, I hate the things 
  235. more than you do.
  236.  
  237.  
  238.                      *** How to Contact the Author ***
  239.  
  240. I always appreciate correspondence from interested users of the software that
  241. I write. I would like to hear from you whether you have praise or 
  242. constructive critscisms about my programs. Do you like them or do you think 
  243. that they are trash? Whatever you think please let me know. The address is at
  244. the end of this section. 
  245.  I am also always on the lookout for new ideas of what software to write. 
  246. What sort of software would you like to buy? If you send me an idea and 
  247. I decide to use it, I will send you a free copy of the full working version
  248. of the resulting program. 
  249. If you send me pictures you have drawn or music you have written on the 
  250. computer and I use them in a future program, then not only will you receive
  251. a free copy of the full program, but I will also send you 20% of all profit
  252. made on the program.The same applies if you have written small programming 
  253. routines, which on their own cannot be used, but which I could use in order
  254. to write good programs. You will of course be credited either in the program
  255. or in the documents (probably both) with the part you played, but the final 
  256. copyright of the whole program will rest with Samsof, however you will retain
  257. the copyright of the particular portion that you wrote. 
  258. If you have written a complete program and would like me to improve on it 
  259. and then sell it for you, you will receive 50% of all profits made by the
  260. program, and if you have written a complete program (using Blitz Basic) which 
  261. you just want me to sell for you then please send me the source code along 
  262. with a covering letter and I will take care of the rest and you will receive 
  263. 80% of all profits made by the program.  
  264.  
  265. In order to contact me for any of the above as well as for general 
  266. correspondence, praise, critiscism, payments, donations, gifts or anything
  267. else please write to:
  268.  
  269.  
  270.                           Samuel Bowers
  271.                           Samsof Software
  272.                           PO Box 11
  273.                           Beccles
  274.                           Suffolk
  275.                           NR34 9JS
  276.                           England
  277.  
  278.           My E-Mail address is: sambowers@thenet.co.uk
  279.  
  280. I would also be very interested to hear from users overseas. In fact, 
  281. there's a free full version of the latest program that I have written, for 
  282. the person who lives furthest away from me (outside of the UK), and has 
  283. written to me, for whatever reason, by 31st December 1996.
  284.  
  285.  
  286.                           *** Credits ***
  287.  
  288. I would like to thank Johnathan Potter, who lives in Australia for writing 
  289. the Fullview program used to display these documents, and particularly for 
  290. allowing anyone to use his program. Nice one Johnathan. If you would like to
  291. thank Johnathan yourself, then just press the A key on your keyboard to get
  292. his address.
  293. Many thanks go to all those at Acid Software for writing the Blitz Basic 
  294. program, without which my program would never have existed. 
  295. I would also like to thank all of you out there who buy my programs. It is 
  296. much appreciated.
  297.  
  298. ****************************************************************************
  299. *********************** The Documents have now ended *********************** 
  300. ****************************************************************************
  301.